home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / ezdiz20s.zip / EZ-DIZ.DOC < prev    next >
Text File  |  1993-05-25  |  11KB  |  241 lines
  1.                                         
  2.                                   EZ-DIZ v2.0
  3.                     Copyright (c) 1992, 1993 By Rick Kuban
  4.  
  5.  
  6.           INTRODUCTION:
  7.           -------------
  8.                EZ-DIZ is a utility program written to automate a PCBoard
  9.           4.5+ sysop's maintainance of directory file lists using the
  10.           FILE_ID.DIZ and DESC.SDI files found in many ZIP/ARC/ARJ/PAK/LZH
  11.           archives. It provides similar functions as the PCBDESC utility,
  12.           but also functions from the command line, unlike PCBDESC, and
  13.           *DOES NOT* require the sysop to perform "Local Uploads".
  14.  
  15.           It may be used as a replacement for PCBDESC.EXE in PCBTEST.BAT,
  16.           manually to process one file at a time, or, by clever use of a
  17.           batch file (as intended), can be used to automatically process an
  18.           entire directory at one time.
  19.  
  20.           It contains the intelligence required to not re-process a file
  21.           that has already been placed in the dir listing, but it can be
  22.           forced to write the description again, if desired. It is suitable
  23.           to run in an event.
  24.  
  25.           EZ-DIZ automatically recognizes ZIP/PAK/ARC/LZH and ARJ
  26.           formats, and, if the appropriate decompressor is available,
  27.           will process the file. If a file in the directory is not an
  28.           archive, it will simply be skipped.
  29.  
  30.  
  31.           STANDARD "DEMO" LICENSE:
  32.           ------------------------
  33.               EZ-DIZ is a Shareware program, and uploading of the code
  34.           to various bulletin boards and Shareware libraries is encouraged.
  35.           Several limitations must be implied, however:
  36.  
  37.           1)  Under no circumstances should the code be modified or dis-
  38.           tributed in any other form than what it was originally supplied
  39.           by the author. The exception is that EZ-DIZ may be compressed
  40.           using techniques other than ZIP, but the de-compressed form of
  41.           EZ-DIZ must remain intact. No files may be added to or removed
  42.           from the archive contents. This explicitly includes bbs ads of
  43.           any kind.
  44.  
  45.           Files included in the original archive are:
  46.  
  47.                    EZ-DIZ.EXE - the executable program file
  48.                    EZ-DIZ.DOC - this documentation file
  49.                    README.1ST - a quick start for old & new users
  50.                    EZDIZ.BAT - sample batch file (single)
  51.                    B-DIZ.BAT - sample batch file (batch)
  52.                    PCBTEST.BAT - sample batch file for upload mode
  53.                    EZ-DIZ.REG - registration form
  54.                    FILE_ID.DIZ  - description file
  55.                    WHATS.NEW - list of new features in version 2.0
  56.  
  57.           2)  EZ-DIZ may not be redistributed in any manner other than
  58.           electronic file transfer unless cleared with the author beforehand.
  59.           Registered versions of EZ-DIZ shall not be redistributed at all.
  60.           No money may be received for EZ-DIZ except to cover for telecom-
  61.           munications/service charges, and in such a case the cost may not
  62.           exceed $5.00 in US funds.
  63.  
  64.           3)  EZ-DIZ may be run for a period of time adequate to allow
  65.           for full testing of the software. If, after running the code for
  66.           one month, you decide not to purchase the registration license,
  67.           you must forfeit this license and remove EZ-DIZ from operation
  68.           on your system(s). You may keep a copy online for distribution
  69.           purposes only.
  70.  
  71.           4)  EZ-DIZ may not be hacked, disassembled, reverse engineered,
  72.           or modified in ANY manner.
  73.  
  74.  
  75.           REGISTRATION LICENSE:
  76.           ---------------------
  77.           1)   Once purchasing the registration license, the license is
  78.           extended for life. All future releases of EZ-DIZ will be made
  79.           available, upon request, for no additional charge (postage and
  80.           handling excepted, if requested on diskette). Registered users
  81.           in the continental US may call Technoid's Toybox BBS and use
  82.           the online EZ-DIZ Registration Upgrade Door to get their
  83.           serialized copy of the latest version of EZ-DIZ.
  84.  
  85.           Upon each issuance of a later revision, registrations will not
  86.           be accepted for older versions (ie... in case of a registration
  87.           fee increase, the newer version must be registered).
  88.  
  89.           2)   The registration license is non-refundable and non-transfer-
  90.           able. The registration license permits the licensee to operate
  91.           EZ-DIZ on one (1) system only. The definition of "system" will be
  92.           construed to include a multiple node network at the same physical
  93.           location, operating under the same bbs name.
  94.  
  95.           3)   Product support and distribution for EZ-DIZ will be provided
  96.           to registered users thru Technoid's Toybox BBS, (214) 226-6017.
  97.           The user should call Technoid's Toybox, after giving the mail time
  98.           to arrive, and read the message directed to them for instructions
  99.           on how to download their registered copy, which will remove the
  100.           "UNREGISTERED COPY" notices from the program.
  101.  
  102.           4)   The registration fee for EZ-DIZ v2.0 is $10.00 in US funds.
  103.           Texas residents must add 8-1/4% sales tax ($10.83 total).
  104.  
  105.           If desired, the user can include an additional $5.00 US with the
  106.           registration fee to cover postage and handling and their copy of
  107.           the registered version of the latest EZ-DIZ will be returned via
  108.           U.S. Mail on 5.25" 360k IBM Format disk.
  109.  
  110.           DISCLAIMER:
  111.           -----------
  112.                Although the program has been tested, and is currently in
  113.           use on the authors bbs, the author assumes no responsibility nor
  114.           liability for any data loss, incurred costs, equipment or other
  115.           damage as a result of the use of EZ-DIZ. The user assumes all
  116.           risk for damages incurred from the use of this product. In any
  117.           case, the limit for damages will not exceed the amount paid for
  118.           registration of EZ-DIZ.
  119.  
  120.           EZ-DIZ has been tested on PCBoard v14.5a & 15.0, multi-node,
  121.           running on a LANtastic v4.0 network under MS DOS v5.0. The
  122.           versions of various decompression programs used in testing are:
  123.  
  124.           PKUNZIP v2.04g / PKUNPAK v3.61 / LHA v2.12 / PAK v2.10 / ARJ v2.10
  125.  
  126.  
  127.           OPERATING EZ-DIZ:
  128.           -----------------
  129.           EZ-DIZ is very simple to operate. No setup or configurations
  130.           are required. It is suggested that a batch file be used to
  131.           call EZ-DIZ in order to eliminate keystrokes. Study the
  132.           enclosed examples for reference.
  133.  
  134.           EZ-DIZ should be placed in any convenient directory, and must
  135.           have available to it either directly, or in the path, of the
  136.           appropriate versions of PKUNZIP/PKUNPAK/PAK/LHA/ARJ in order to
  137.           be able to retrieve the FILE_ID.DIZ or DESC.SDI file from the
  138.           archives. EZ-DIZ may be called from any directory, as long as
  139.           it is on the path. * Note that this is different from previous
  140.           versions, which required a registration keyfile. *
  141.  
  142.           EZ-DIZ relies on three command line arguments passed to it upon
  143.           invocation. The first argument is the fully qualified path and
  144.           filename of the PCBoard directory file to be updated (Example:
  145.           C:\PCB\GEN\UPDIR). The second argument is the name of the
  146.           archived file to be processed (Example: D:\UPLOADS\EZ-DIZ.ZIP).
  147.           An example of such a command line might be:
  148.  
  149.           C:\PCB> EZ-DIZ C:\pcb\gen\updir d:\uploads\ez-diz.zip <enter>
  150.  
  151.           Use of a batch file with replaceable parameters would look
  152.           like this:
  153.  
  154.           EZDIZ.BAT
  155.           REM - Process one zip file
  156.           echo off
  157.           ez-diz c:\pcb\gen\updir d:\uploads\%1
  158.  
  159.           The above would be called as:
  160.  
  161.           C:\UPLOADS> DIZ ez-diz.zip <enter>
  162.  
  163.           The third parameter is a single letter (F/f/U/u) to enable the
  164.           Forced Write or UPLOAD options described later.
  165.  
  166.  
  167.           B-DIZ BATCH FILE:
  168.           -----------------
  169.           When calling up EZ-DIZ, you may want to automatically process
  170.           the entire directory without intervention. Consider the following
  171.           batch file example:
  172.  
  173.           B-DIZ.BAT
  174.           REM - Process all files in d:\uploads
  175.           for %%x in (d:\uploads\*.*) do ez-diz c:\pcb\gen\updir %%x
  176.  
  177.           The above command line will process every archive file in the
  178.           specified uploads directory, placing any FILE_ID.DIZ or DESC.SDI
  179.           descriptions found into the directory file UPDIR in the C:\PCB\GEN
  180.           subdirectory. This process runs very quickly. By calling one
  181.           or more batch files with different archive format specifications
  182.           (ie... d:\uploads\*.arj would process all ARJ), one can exercise
  183.           great power over which files are supported or processed.
  184.  
  185.           OPTIONS:
  186.           --------
  187.           EZ-DIZ now has 2 optional modes of operation:
  188.  
  189.           1. Forced Write Mode - If the command line switch F is given,
  190.              EZ-DIZ will write any found FILE_ID.DIZ or DESC.SDI
  191.              description to the target directory file regardless of
  192.              whether or not the description already exists. This mode is
  193.              useful to replace any old user entered descriptions that
  194.              are inadequate with a better description that exists in the
  195.              file itself.
  196.  
  197.           2. UPLOAD Mode - If the command line switch U is given, EZ-DIZ
  198.              will work as a replacement for PCBDESC.EXE in the PCBTEST.BAT
  199.              file, giving more flexability in retrieving imbedded file
  200.              descriptions from all uploaded archive formats, instead of
  201.              being limited to just ZIP formats as is with PCBDESC.EXE.
  202.  
  203.  
  204.           ACKNOWLEDGEMENTS:
  205.           -----------------
  206.           PAK; NoGate Consulting
  207.           LHA; Haruyasu Yoshizaki
  208.           ARJ; Robert K. Jung
  209.           PKUNZIP, PKUNPAK; PKWare, Inc.
  210.           PCBoard, PCBDesc, PCBFiler; Clark Development Co., Inc
  211.  
  212. ------------------------------------------------------------------------------
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.